/*
 * Copyright (C) 2008 Pleyo.  All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1.  Redistributions of source code must retain the above copyright
 *     notice, this list of conditions and the following disclaimer.
 * 2.  Redistributions in binary form must reproduce the above copyright
 *     notice, this list of conditions and the following disclaimer in the
 *     documentation and/or other materials provided with the distribution.
 * 3.  Neither the name of Pleyo nor the names of
 *     its contributors may be used to endorse or promote products derived
 *     from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY PLEYO AND ITS CONTRIBUTORS "AS IS" AND ANY
 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED. IN NO EVENT SHALL PLEYO OR ITS CONTRIBUTORS BE LIABLE FOR ANY
 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
#ifndef StringBuffer_h
#define StringBuffer_h
/**
 *  @file  StringBuffer.t
 *  StringBuffer description
 *  Repository informations :
 * - $URL$
 * - $Rev$
 * - $Date$
 */
#include "BALBase.h"

#include <wtf/Assertions.h>
#include <wtf/Noncopyable.h>
#include <wtf/unicode/Unicode.h>

namespace WebCore {

class StringBuffer : Noncopyable {
public:
    /**
     * StringBuffer constructor
     * @param[in] : length
     */
    explicit StringBuffer(unsigned length);

    /**
     * StringBuffer destructor
     */
    ~StringBuffer();

    /**
     * shrink
     * @param[in] : new length
     * @code
     * s->skrink(5);
     * @endcode
     */
    void shrink(unsigned newLength);

    /**
     * resize
     * @param[in] : new length
     * @code
     * s->resize(5);
     * @endcode
     */
    void resize(unsigned newLength);

    /**
     * get length 
     * @param[out] : length
     * @code
     * unsigned l = s->length();
     * @endcode
     */
    unsigned length() const ;

    /**
     * get characters 
     * @param[out] : characters
     * @code
     * UChar *c = s->characters();
     * @endcode
     */
    UChar* characters() ;

    /**
     * operator[] 
     */
    UChar& operator[](unsigned i) ;

    /**
     * release
     * @param[out] : unicode characters
     * @code
     * UChar *c = s->release();
     * @endcode
     */
    UChar* release() ;

private:
    unsigned m_length;
    UChar* m_data;
};

}

#endif




